home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Taifun / Taifun 257 (1993-09-10)(Manewaldt, A.)(DE)(PD).zip / Taifun 257 (1993-09-10)(Manewaldt, A.)(DE)(PD).adf / SIP / SIP_ENG.doc < prev    next >
Text File  |  1993-09-07  |  13KB  |  393 lines
  1.  
  2.                  SIP V2.12
  3.  
  4.                 - FREEWARE -
  5.  
  6.          (c) 1992-93 by Andreas R. Kleinert. All rights reserved.
  7.  
  8.           This program was written under OS V3.00 and is therefore
  9.           fully compatible. It needs OS >= V2.04.
  10.           This program needs 'asl.library'      V37+ (in "LIBS:")
  11.                  and 'diskfont.library' V37+ (in "LIBS:").
  12.  
  13.           Release Date : 10.06.1993
  14.  
  15.  
  16.     Copyright :
  17.     ===========
  18.  
  19.     The program SIP V2.12 and its documentation files are
  20.     (C)opyright 1992-93 by Andreas R. Kleinert. All rights reserved.
  21.  
  22.  
  23.     Disclaimer :
  24.     ============
  25.  
  26.     The author takes no responsibility for any results of the use of this
  27.     program.
  28.     This software is provided "AS IS" and there is no warranty of any kind,
  29.     so that you use this software at your own risk.
  30.  
  31.  
  32.     Distribution :
  33.     ==============
  34.  
  35.     The program SIP V2.12 is freely distributable (FREEWARE).
  36.     You may copy it, if the copyright notice is left intact and
  37.     all of its parts are included in the distribution.
  38.     This program must not be included in commercial packages or commercial
  39.     program collections without my written permission.
  40.     This program must not be sold in any way, but it is allowed to take
  41.     a nominal fee including the costs for copying.
  42.  
  43.     This program may be put on public domain disks or included in public
  44.     domain disk libraries.
  45.     Special permission hereby goes to Fred Fish's AmigaLib-Disks and
  46.     the german series TAIFUN, FRANZ, TIME, GPD and Amiga Szene.
  47.  
  48.     This program may also be distributed via electronic mail and may be
  49.     put into mailboxes as long as the redistribution conditions are
  50.     respected in all points.
  51.  
  52.     By using or distributing this program you automatically agree to
  53.     all of the above conditions and terms.
  54.  
  55.  
  56.     Intention :
  57.     ===========
  58.  
  59.     "SIP" stands for "System Information Program".
  60.  
  61.     SIP may look very similar to other programs with similar intentions,
  62.     but has really nothing to do with them except of the task to fulfil.
  63.  
  64.     What I wanted to create, was a program that should bring the same comfort
  65.     to you as other programs, but which also should be compatible to the new
  66.     OS 2.04 and use the special features of the new Kickstart.
  67.  
  68.  
  69.     Function :
  70.     ==========
  71.  
  72.     SIP allows you to watch and manipulate most of the elementary parts of
  73.     the Operating System of your Amiga, as (e.g.) Tasks, Libraries, Devices,
  74.     Ports and Windows.
  75.     It also brings you the possibility of viewing some of the most important
  76.     vectors in the system and to clear them, to make sure to keep your system
  77.     free of viruses and all the other garbage which affects working with
  78.     your Amiga.
  79.  
  80.     SIP is written under V3.00 of the AmigaOS and only runs under OS V2.04+.
  81.     Which means that the lowest accepted library version is V37 !
  82.  
  83.  
  84.     Usage :
  85.     =======
  86.  
  87.     Function-Overview :
  88.     -------------------
  89.  
  90.      Gadget         Function
  91.      ----------------------------------------------------------------------
  92.  
  93.      Tasks         Show Tasks by name and more
  94.      Windows         Show Windows by name
  95.      Libraries         Show Libraries by name and more
  96.      Devices         Show Devices by name and more
  97.      Resources         Show Resources by name and more
  98.      Ports         Show Ports by name and more
  99.      Residents         Show Residents by name and more
  100.      Interrupts      Show Interrupts by number and more
  101.      Vectors         Show some vectors (CoolCapture, etc.)
  102.      Memory         Show information about memory
  103.      Mount         Show all mounted devices by name
  104.      Assign         Pop up a File-Requester to show assigns and volumes
  105.      Fonts         Pop up a Font-Requester to show all available fonts
  106.      Hardware         Give some information about the Hardware
  107.  
  108.  
  109.      Action-Gadget     Function
  110.      ----------------------------------------------------------------------
  111.  
  112.      Remove!         Remove a Task/Window/Library/Device/Resource/Port or
  113.              Interrupt
  114.              (ONLY when in this Mode).
  115.  
  116.      Priority!         Set new Priority for a Task/Library/Device/Resource/
  117.              Port or Resident
  118.              (ONLY when in this Mode).
  119.  
  120.      Reserved!         (Not selectable, reserved.)
  121.  
  122.      Clear!         Clear Cold-/Cool- and WarmCapture entries in SysBase
  123.              (ONLY when in this Mode).
  124.  
  125.  
  126.      <Close-Gadget>     (see MENUS : "Quit")
  127.  
  128.  
  129.      Menu         Function
  130.      ----------------------------------------------------------------------
  131.  
  132.      Info         About SIP and me
  133.      Help         About SIP's gadgets
  134.      Quit         You may choose between three possibilities :
  135.  
  136.                - Cancel              1. Go back.
  137.  
  138.                               2. Iconify
  139.                - O.K.            /
  140.                             \
  141.                               3. Really Quit
  142.  
  143.  
  144.        1st Note : "Iconify" saves about 50000 Bytes of memory (Screen, ...).
  145.  
  146.        2nd Note : You may click on all the gadgets without destroying anything,
  147.           EXCEPT the following gadgets :
  148.  
  149.               - Remove!     Remove s.th., if s.th. is chosen
  150.               - Clear!        Clear vectors, if clicked VECTORS before
  151.               - Priority!   Set priority, if s.th. is chosen
  152.               - Reserved!   (Not selectable, reserved.)
  153.  
  154.        Here's an example, how to "Remove!" a Task from the system :
  155.  
  156.        Example :
  157.        ---------
  158.  
  159.            Action          Gadget / Text to select
  160.            --------------------------------------
  161.  
  162.            <Clicked on>   Tasks
  163.            <Selected>     "Background CLI"
  164.            <Clicked on>   Remove
  165.  
  166.            Then you'll see, that the task "Background CLI" will have been
  167.            removed.
  168.  
  169.  
  170.      Menu            Function
  171.      ----------------------------------------------------------------------
  172.  
  173.      Project/Help        Opens the Help-Window of SIP
  174.         /Info        Opens the Info-Window of SIP
  175.         /Start WB        Starts the Workbench
  176.      Switch/SIP Dos Tools   Switches to the "SIP Dos Tools"
  177.  
  178.  
  179.      SIP Dos Tools :
  180.      ---------------
  181.  
  182.      In the Menu "SIP Dos Tools" you may view Bootblocks of Disks
  183.      (DF1: to DF3:) or format Disks or Dos-Volumes (DF1: bis DF3,
  184.      any Devices).
  185.  
  186.      Please note, that for formatting of 720 KB-Disks the appropriate
  187.      Handlers (PC0: bis PCx:) have to be mounted and that Quick-Formatting
  188.      of Amiga- to 720 KB-Disks or of 720 KB- to Amiga-Disks cannot work.
  189.      Therefore for this, as well as for new Disks, please select
  190.      Hard-Formatting.
  191.      Also the maximum length for the name of 720 KB-Disks is 12 characters :
  192.      the rest will be ignored.
  193.  
  194.      For Hard-Formatting "SYS:System/Format" is used.
  195.  
  196.  
  197.     Notes :
  198.     =======
  199.  
  200.     On slower (7.1x MHz) Amigas it is possible, that showing some "types" of
  201.     information may need some time - especially viewing the Residents -
  202.     Don't panic if your Amiga doesn't react for two or three seconds
  203.     (the mouse pointer doesn't move).
  204.     This is not a DeadLock, this is just because of some Forbid()/Permit()
  205.     calls and because of the mass of data to be shown in the gadtools-Gadgets.
  206.     Another reason is, that the -Gadgets also need a specific amount
  207.     of CPU-time (IDCMP_INTUITICKS).
  208.  
  209.     So wait a moment, before you just "CTRL-Amiga-Amiga" ! O.K. ?
  210.  
  211.     Well : While viewing e.g. the Residents, all Tasks and Interrupts are
  212.     desactivated for a time, which means that, e.g. a running background
  213.     music may sound somewhat strange for a moment.
  214.  
  215.  
  216.     Construction :
  217.     ==============
  218.  
  219.     - SIP uses a PAL-Screen (640x256) ! Sorry, NTSC-Users !
  220.  
  221.     - The surface of this program has been created under use of the famous
  222.       program "GadToolsBox V1.4", written by Jan van den Baard.
  223.  
  224.     - SIP makes use of the 'asl.library' V37+ and the 'diskfont.library' V37+
  225.       of the Workbench V2.04+.
  226.  
  227.     - Many of the functions of this program are to find as more powerful and
  228.       more complexe CLI-Commands in my CLI-/Shell-Package "AKCC", which is
  229.       SHAREWARE and to find on several Public Domain Series.
  230.       The current version/release number of AKCC is V2.2.0 (at the moment
  231.       with 35 commands).
  232.  
  233.  
  234.     Correspondence :
  235.     ================
  236.  
  237.     If you like, you may send me some money. Perhaps this will motivate me
  238.     to continue programming such programs or just making updates of
  239.     this one. Send bug-reports, suggestions, money (!) or whatever to :
  240.  
  241.        Andreas R. Kleinert,
  242.        Grube Hohe Grethe 23,
  243.        D-57074 Siegen
  244.        Germany.
  245.  
  246.  
  247.     History :
  248.     =========
  249.  
  250.      V2.12 : (10.06.1993, original size : 35692 Bytes)
  251.      -------
  252.  
  253.       - now with additional menupoint "SIP Dos Tools"
  254.     (integration of "KBoot V1.02" and "Well-Format V1.00") :
  255.  
  256.      - Viewing of Bootblocks of Disks
  257.      - Diskformatting quick/hard, OFS/FFS ic
  258.        (quick : internal, hard : external ("SYS:System/Format") )
  259.       - improved error-handling in low-memory situations
  260.       - removed unnecessary code
  261.       - changed Task-Display
  262.       - changes in Residents-/Libraries-/Devices-/Handler-Viewer
  263.       - another bug-fix in the Resident-Viewer
  264.       - bug-fix in the Resource-Viewer
  265.  
  266.  
  267.      V2.06 : (12.05.1993, original size : 29708 Bytes)
  268.      -------
  269.  
  270.       - Hardware : added Agnus/Alice recognition. Not perfect so far !?
  271.       - the "Resident-View-WB-Known-Bug" now seems to be FINALLY fixed
  272.       - internal changes to the Interrupt-Routine
  273.       - some optimizations
  274.  
  275.  
  276.      V2.05 : (15.04.1993, original size : 29964 Bytes)
  277.      -------
  278.  
  279.       - Remove! : new Requester for Tasks/Processes :
  280.      1. RemTask
  281.      2. Break Task (CTRL-C, -D, -E or -F)
  282.       - Hardware : recognizes Denise-/Lisa-Chips via their ID
  283.       - new Menu for starting Workbench
  284.  
  285.  
  286.      V2.04 : (April 1993, original size : 28088 Bytes)
  287.      -------
  288.  
  289.       - Resident-Viewer still crashed sometimes. Bug hopefully fixed now.
  290.       - new abort-routine (V33-style Error-Requester, runs anywhere).
  291.       - found out, that Asl-Font-Requester at least needs "diskfont.library"
  292.     of OS V2.0x to pop up. Added note to Doc-File.
  293.  
  294.  
  295.      V2.03 : (original size : 27856 Bytes)
  296.      -------
  297.  
  298.       - improvements
  299.       - more informationen about Handler ("MOUNT" before)
  300.  
  301.  
  302.      V2.02 : (original size : 27668 Bytes)
  303.      -------
  304.  
  305.       - use of SAS/C V6.00
  306.       - fixed a bad bug, which occured under OS V3.0
  307.     (Kickstart V39.106, exec.library V39.47, intuition.library V39.2084,
  308.      gadtools.library V39.356), but _not_ under OS V2.04 !!!
  309.     If selected the ListView-Gadget, a "class&IDCMP_CLOSEWINDOW"
  310.     resulted in TRUE, although it should not.
  311.     This should have been filtered out by "GT_GetIMsg()", but was not.
  312.     Now using an absolutely clear "class==IDCMP_CLOSEWINDOW".
  313.       - added auto-activation
  314.       - re-added possibility to watch files in Assign-Requester
  315.       - fixed handling of Resident-IDs (might have been crashed, if no
  316.     valid ID-Pointer (or NULL) set), Forbid()/Permit()
  317.       - removed memory-values from "Hardware" and fixed those values in
  318.     "Memory" (so that "not FAST ..." is reported, if 0x00000000 is
  319.     found)
  320.       - changed/added some other things
  321.       - improved doc-file (even older revision-entries)
  322.  
  323.  
  324.      V2.01 : (original size : 27672 Bytes)
  325.      -------
  326.  
  327.       - added some "__aligned" statements
  328.       - fixed another (possible) bug-source in string-buffering
  329.       - closed silly "memory black-hole" in "Mount"-Option
  330.  
  331.  
  332.      V2.00 :
  333.      -------
  334.  
  335.       - changed name from "BRTM" to "SIP", to show that it is not just
  336.     a clone of other programs with its intention
  337.       - complete re-design of the Surface, because of use of
  338.     GadToolsBox V1.4 : code should be better now (less
  339.     "by hand"-changes because of multiple-windows technique).
  340.       - changes in Help- and Info-Window, as well as small
  341.     differences in quality of design.
  342.       - fixed a bug in string-buffering and conversion of strings
  343.     for Screen-Display
  344.     (perhaps this wasn't the last one ...)
  345.       - AGAIN : improvements on this doc-file
  346.     (yes, you are still reading it ...)
  347.  
  348.  
  349.      V1.05 :
  350.      -------
  351.  
  352.       - fixed some "surface" things ("More" now is fully obsolete),
  353.     changed some texts inside
  354.       - fixed a bad bug in clear-routine for gadgets
  355.       - consequent use of "__regargs" (SAS/C V5.10a/b)
  356.       - improves on this doc-file
  357.     (yes, this which you are reading now ...)
  358.       - Asl-Requester (for Assigns) now for Dirs only
  359.     (no selection of files possible any longer)
  360.       - Requesters are (should be) bigger
  361.  
  362.      V1.01 :
  363.      -------
  364.       - self-detaches from CLI/Shell by "cback.o"
  365.       - improved display of library-data
  366.       - more information about resources
  367.       - number of messages displayed, when "hanging" at ports
  368.       - "$VER"sion-string for use with the CLI-/Shell-Command "Version"
  369.       - closes the remaining stdio-window on the WB
  370.     (=> no longer error-texts on the WB, but in the CLI/Shell).
  371.  
  372.      V1.00 :
  373.      -------
  374.       - First and initial release.
  375.  
  376.  
  377.     Specific Copyrights :
  378.     =====================
  379.  
  380.     - "GadToolsBox" (V1.0/V1.4) is FREEWARE and
  381.       (c) 1991,92 by Jan van den Baard.
  382.     - "AKCC" V2.2.0 is SHAREWARE and
  383.       (c) 1990-93 by Andreas R. Kleinert.
  384.  
  385.  
  386.     Copyrights :
  387.     ============
  388.  
  389.     Some of the mentioned names or products above may be copyrighted by
  390.     companies or trademarks of companies.
  391.  
  392.  
  393.